package cn.iocoder.yudao.module.system.service.product;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.system.controller.admin.product.vo.*;
import cn.iocoder.yudao.module.system.dal.dataobject.product.ProductDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;
import cn.iocoder.yudao.module.system.dal.dataobject.product.ProductRenewalItemDO;

/**
 * 系统产品 Service 接口
 *
 * @author 数创万维
 */
public interface ProductService {

    /**
     * 创建系统产品
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProduct(@Valid ProductSaveReqVO createReqVO);

    /**
     * 更新系统产品
     *
     * @param updateReqVO 更新信息
     */
    void updateProduct(@Valid ProductSaveReqVO updateReqVO);

    /**
     * 更新指定产品的售出数量
     * @param count 数量
     * @param proId 产品id
     * @since 2024-05-15
     * @author PetePower
     */
    void updateProductSaleCount(Integer count, Long proId);

    /**
     * 删除系统产品
     *
     * @param id 编号
     */
    void deleteProduct(Long id);

    /**
     * 获得系统产品
     *
     * @param id 编号
     * @return 系统产品
     */
    ProductDO getProduct(Long id);
    ProductDO getProductByCode(String code);

    /**
     * 获得产品列表
     * @since 2024-04-22
     * @author PetePower
     * @return 产品列表
     */
    List<ProductDO> getProductList();

    /**
     * 获取免费的套餐（默认额度大于0的）
     * @since 2024-04-23
     * @author PetePower
     * @return
     */
    List<ProductDO> getFreeProductList();

    /**
     * 获得系统产品分页
     *
     * @param pageReqVO 分页查询
     * @return 系统产品分页
     */
    PageResult<ProductDO> getProductPage(ProductPageReqVO pageReqVO);


    /**
     * 根据产品id获取续费项
     *
     * @param productId 产品id
     * @return
     * @author PetePower
     * @since 2024-05-08
     */
    List<ProductRenewalItemDO> getRenewalItemList(Long productId);

    ProductRenewalItemDO getRenewalItem(Long itemId);

    /**
     * 根据产品 code 获取续费项
     *
     * @param productCode 产品id
     * @return
     * @author PetePower
     * @since 2024-05-08
     */
    List<ProductRenewalItemDO> getRenewalItemList(String productCode);

    Long createProductRenewalItem(ProductRenewalItemSaveReqVO saveReqVO);

    void updateProductRenewalItem(ProductRenewalItemSaveReqVO saveReqVO);

    void deleteProductRenewalItem(Long id);

}